home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-13 / fix304.zip / FIX.DOC < prev    next >
Text File  |  1992-08-08  |  8KB  |  173 lines
  1. FIX-File Fix, Version 3.04                             08-Aug-92
  2.  
  3.  
  4. Binary editor, with record orientation, which allows searches for either
  5. text or hex strings.  Default record size automatically set to maximum
  6. allowed by number of lines on screen.  (Maximum record size is 576 bytes
  7. with a 50-line screen.)  The program draws from a common library of routines
  8. shared with other programs I've written.  Color or black-and-white mode
  9. automatically determined at program start-up.  New:  Typing of extended
  10. ASCII characters enabled (for non-American users with modified keyboards).
  11.  
  12. Contents:
  13. =========
  14. Purpose
  15. Display
  16. Syntax
  17. Switches
  18. Commands
  19. Program background
  20.  
  21. Purpose:
  22. ========
  23. For easy viewing and editing of any type of file, text or binary, read-only,
  24. hidden or system.  Will not extend the size of a file, only replace
  25. characters.
  26.  
  27. FIX is a free program.
  28.  
  29. Display:
  30. ========
  31. The program adjusts for color based on the display mode.  However, if the
  32. user has a color graphics card, but no color monitor, the display may be
  33. improved by using the DOS command "MODE BW80".  Conversely, color mode may
  34. be forced on by using "MODE CO80".
  35.  
  36. A command-line switch is also available to force black-and-white mode.  See
  37. "Switches" below.
  38.  
  39. EGA/43- and VGA/50-line modes are supported.  At program start-up, an
  40. attempt is made to detect the actual number of lines on the screen, up to a
  41. maximum of 50, and to adjust the display accordingly.
  42.  
  43. Included in the distribution archive is SAMPLE.DAT, a sample binary data
  44. file which includes all 256 possible characters in numerical sequence (all
  45. of which are available for viewing in a file, with the exception of ASCII
  46. codes 0 and 255).  You may use it to familiarize yourself with how the
  47. program displays characters.
  48.  
  49. Syntax:
  50. =======
  51.  
  52.         Usage:  FIX [switches] [filespec]
  53.  
  54. If no extension is specified for "filespec", ".*" is assumed.  If a valid
  55. filename is specified unambiguously, the file is immediately displayed. 
  56. Either specifying "filespec" using wildcards, or specifying a drive or
  57. directory name causes a scrollable directory window to pop up.  Simply
  58. typing the program name is the same as specifying "*.*".
  59.  
  60.         Examples:       FIX c:          <- current directory of drive C:
  61.                         FIX d:\         <- root of drive D:
  62.                         FIX \dbase\data <- data subdirectory of \dbase
  63.  
  64. Switches:
  65. =========
  66. There is at present only one switch.
  67.  
  68. /BW     Black-and-White mode
  69.  
  70. Either '/' or '-' may be used to specify switches.
  71.  
  72. Entering an invalid switch causes the program to display a brief help screen
  73. then exit.
  74.  
  75.         Examples:       FIX /h
  76.                         FIX -?
  77.  
  78. Commands: 
  79. =========
  80.  
  81.     Key  Mnemonic  Description              Alternate Command Keys
  82.     ---  --------  -----------------------  ----------------------
  83.     F1   Help      Help screen              H
  84.  
  85.     F3   Size      Change record size       S
  86.     F4   Edit      Edit displayed record    E
  87.     F5   Goto      Select by record number  G
  88.     F6   First     View first record        F, <Home>
  89.     F7   Prev      View previous record     P, <Up>, <PgUp>
  90.     F8   Next      View next record         N, <Dn>, <PgDn>, <Ret>
  91.     F9   Last      View last record         L, <End>
  92.     F10  Quit      Quit program             Q, <Esc>
  93.  
  94.     Alt-G    Goto file offset
  95.     Alt-F    Find text                 Ctrl-F   Find bytes
  96.     Alt-H    Change header length      Alt-O    Change record offset
  97.  
  98. Use <Alt-G> to "Go-to" a specific offset within a file, [0..FileSize-1]. 
  99. Useful for quickly moving to a location specified by an external program
  100. that generates offset information - DOS's own COMP command, for example. 
  101. The position you specify will appear in the upper-left corner and the record
  102. offset will be adjusted accordingly (normally zero).
  103.  
  104. Use <Alt-F> to specify a text string to "Find".  The search starts from the
  105. next position after the current position in the file.  Once a search string
  106. is specified, the program "remembers" it the next time the <Alt-F> hot-key
  107. is used, so you can find successive occurrences of the same string by
  108. repeatedly pressing <Alt-F> followed by <Ret>.  The search is not
  109. case-sensitive so upper- and lower-case alphabetic characters are handled
  110. equivalently.  Wildcards are supported.  '?' will match any single
  111. character.  '*' will match any sequence of zero or more characters.
  112.  
  113.         Examples:  "c?n" will match "Can" and "con".
  114.                    "PC*S" will match "pcs", "PC-DOS" and "PC-MOS"
  115.  
  116. Use <Ctrl-F> to specify an arbitrary sequence of bytes to "Find".  Two
  117. windows are available for data entry.  The top (ASCII) window is for
  118. entering characters you can type at the keyboard.  The bottom (Hex) window
  119. allows you to enter any byte values in hex.  What is typed in one window is
  120. echoed in the other.  To switch windows, you may cursor in the appropriate
  121. direction or just press <Tab>.  <Ret> to initiate the search.  <Esc> if you
  122. change your mind about searching.  The search begins with the next position
  123. after the current position in the file.  Once a sequence of bytes is
  124. specified, the program "remembers" it the next time the <Ctrl-F> hot-key is
  125. used, so you can find successive occurrences of the same sequence by
  126. repeatedly pressing <Ctrl-F> followed by <Ret>.  The search is
  127. case-sensitive so upper- and lower-case alphabetic characters are distinct.
  128.  
  129. Use <Alt-H> to specify the length of a "Header" at the start of a file. 
  130. Once a non-zero header length is specified, the program will skip over the
  131. specified number of bytes at the start of a file and start counting record
  132. beginning with the byte after the "header".  To move back into the header
  133. area, use <Alt-H> again to change the header length back to zero.
  134.  
  135. Use <Alt-O> to specify the "Offset" within a record [0..RecLen-1] that the
  136. program will use to start displaying a record.  Bytes starting at that
  137. offset will appear at the upper-left corner of the display.  This is useful
  138. for reposition the display after a successful search.  (Using the <Home> and
  139. <End> commands will also reset the record offset to zero.)
  140.  
  141. Record-edit mode:
  142. -----------------
  143. When in record-edit mode, you may use the down arrow key to "cursor down" to
  144. the hex level and edit characters by their hex codes.  The <Tab> key will
  145. take you quickly to the ends of the rows.  To save your changes after
  146. editing, press the <Ret> key.  You will be prompted for comfirmation.  Use
  147. the <Esc> key to abort changes made without saving them.
  148.  
  149. Editing of read-only files is allowed.  After editing such a file, the file
  150. attributes are left unchanged from before, except that the archive bit is
  151. always set.
  152.  
  153. Program background:
  154. ===================
  155. This program has evolved starting from my CP/M days, when I took over the
  156. work of another programmer in maintaining a system of interpreted BASIC
  157. programs which made extensive use of random-record data files.
  158.  
  159. The original version of this program was written in Pascal because it seemed
  160. the best tool for the job at the time.  As I progressed through different
  161. languages, I rewrote this utility a number of times, each with little or no
  162. reference to previous source code.  Each resulting program thus had a flavor
  163. of its own.  The current series is written in JPI TopSpeed Modula-2.
  164.  
  165. --
  166.  
  167.                 Raymond T. Kaya
  168.                 P. O. Box 1436
  169.                 Honolulu, HI  96806
  170.  
  171.                 CompuServe:  71230,2500
  172.                 GEnie     :  R.KAYA1
  173.